package com.wwy.hello_knife4j.controller;

import com.wwy.hello_knife4j.entity.User;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/user")
@Tag(name = "用户信息管理")
public class HelloController {

    /**
     * `@Tag`注解用于对接口进行分类，相同`Tag`的接口会放在同一个菜单。
     *
     * `@Operation`用于对接口进行描述。
     *
     * `@Parameter`用于对HTTP请求参数进行描述
     * @param id
     * @return
     */
    @Operation(summary = "根据id获取用户信息")
    @GetMapping("getById")
    public User getUserById(@Parameter(description = "用户id") @RequestParam Long id) {
        User user = new User();
        user.setId(id);
        user.setName("zhangsan");
        user.setAge(11);
        user.setEmail("zhangsan@email.com");
        return user;
    }
}